KCGetKeychain

KCGetKeychain
Header:	Keychain.h		Carbon status:	Under Evaluation

Determines the location of a keychain item.

OSStatus KCGetKeychain (
    KCItemRef item, 
    KCRef *keychain
);

item: A reference to the keychain item whose keychain location you wish to determine. If you pass a reference to a keychain item whose keychain is locked, KCGetKeychain returns the result code errKCInvalidItemRef.
keychain: On return, a pointer to the keychain containing the specified item.

function result: A result code. The result code errKCInvalidItemRef indicates that the specified keychain item reference was invalid.

DISCUSSION

You can use the KCGetKeychainfunction to find the location of keychain items. The search is only performed on unlocked keychains. KCDeleteItem may display the Unlock Keychain dialog box if the keychain containing the item is currently locked.

SPECIAL CONSIDERATIONS

The keychain reference returned by KCGetKeychain should be released by calling the function KCReleaseItem.

VERSION NOTES

Available beginning with Keychain Manager 2.0.

AVAILABILITY

Under evaluation for Carbon. Available in CarbonLib 1.0 and later when KeychainLib 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by KeychainLib 1.0 and later.